home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / a86b.arc / EXMAC.DOC < prev    next >
Text File  |  1986-06-22  |  2KB  |  30 lines
  1. ---EXMAC.DOC---
  2.  
  3. EXMAC Macro Expansion Tool
  4.  
  5. There is a tool called EXMAC which will help you troubleshoot A86 program lines
  6. that call macros.  If you are not sure about what code is being generated by
  7. your macro calls, EXMAC will tell you.
  8.  
  9. To use this tool, you must first assemble your macro definitions, to produce a
  10. symbol-table file.  If your entire program assembled without errors, then you
  11. will already have this symbols-file; it is usually called myprog.SYM, where
  12. "myprog" is the name of your .COM file.  If your program did not assemble
  13. correctly, the symbol-table file will be named "fname.SYM", where fname is
  14. the name of the source file that contained errors.
  15.  
  16. EXMAC can be used in two different ways.    First, it can be used as an
  17. interactive program.  You invoke the program in this way by typing just
  18. "EXMAC myprog", where myprog.SYM is the name of the symbols-file.  Then you can
  19. type in any number of macro-call lines.  After each line, the program will
  20. display the expanded program text it produces.  If the program does not think
  21. your line is a macro call, it will simply echo the line back to you.
  22.  
  23. The second way of using EXMAC is to feed a source-file to it.  It will output
  24. the equivalent source-file with the macros expanded.  You may then, if you wish,
  25. rename the new file as the original source file, and assemble the new file.
  26. This method is useful if you get an error on a macro expansion line, and you
  27. don't know where the error came from.   To use EXMAC in this second way, you
  28. simply redirect standard input and output: "EXMAC myprog <in >out".
  29.  
  30.